설치
목차
Hugo 빠른 시작 절차를 따라 빠르게 시작할 수 있습니다.
상세한 설치 지침은 아래를 참고하세요. 테마 업데이트에 대한 지침도 있습니다.
설치 #
Hugo와 Congo를 사용하여 완전히 빈 상태에서 시작하는 방법을 안내합니다. 이 가이드에서 언급된 대부분의 종속성은 사용하는 플랫폼의 패키지 관리자를 사용하여 설치할 수 있습니다.
Hugo 설치 #
Hugo를 사용한 적이 없다면 로컬 머신에 설치해야 합니다. 명령 hugo version
을 실행하여 이미 설치되어 있는지 확인할 수 있습니다.
Hugo 설치 지침을 참고하세요.
새로운 사이트 생성 #
명령 hugo new site mywebsite
을 실행하여 mywebsite
이라는 이름의 새로운 Hugo 사이트를 생성합니다.
프로젝트 디렉토리 이름은 자유롭게 지정할 수 있지만, 아래 지침은 mywebsite
이라는 이름을 사용한다고 가정합니다. 다른 이름을 사용하는 경우 적절히 대체하세요.
Congo 테마 다운로드 #
Congo 테마를 Hugo 사이트에 설치하는 방법은 여러 가지가 있습니다. 가장 쉽고 유지 관리가 쉬운 방법부터 가장 어려운 방법까지 순서대로 나열하면 다음과 같습니다.
문서에는 위와 같이 나와있지만, 저는 Git 서브모듈 방법을 사용했습니다.
Hugo 모듈 사용 #
이 방법은 가장 빠르고 쉽습니다. Hugo는 Go를 사용하여 모듈을 초기화하고 관리하므로 go
가 설치되어 있는지 확인해야 합니다.
-
다운로드 및 설치. 명령
go version
을 사용하여 이미 설치되어 있는지 확인할 수 있습니다.Go 버전 1.12 이상을 사용하고 있는지 확인하세요. Hugo는 모듈을 올바르게 작동하기 위해 이를 필요로 합니다. -
위에서 생성한 Hugo 프로젝트 디렉토리에서 웹사이트에 대한 모듈을 초기화합니다.
# 프로젝트가 GitHub에서 관리되는 경우 hugo mod init github.com/<username>/<repo-name> # 프로젝트가 로컬에서 관리되는 경우 hugo mod init my-project
-
새 파일
config/_default/module.toml
을 생성하고 다음을 추가합니다.[[imports]] path = "github.com/jpanther/congo/v2"
-
hugo server
를 사용하여 서버를 시작하고 테마가 자동으로 다운로드됩니다. -
테마 설정 파일을 계속 진행하세요.
Git 서브모듈 사용 #
이 방법을 사용하려면 로컬 머신에 Git이 설치되어 있어야 합니다.
위에서 생성한 Hugo 웹사이트 디렉토리로 이동하여 새로운 git
저장소를 초기화하고 Congo를 서브모듈로 추가합니다.
cd mywebsite
git init
git submodule add -b stable https://github.com/jpanther/congo.git themes/congo
그런 다음 테마 설정 파일을 계속 진행하세요.
수동 파일 복사 #
-
테마 소스 코드의 최신 릴리스를 다운로드합니다.
Github에서 다운로드 -
아카이브를 추출하고
congo
폴더를 Hugo 프로젝트의 루트 폴더에 있는themes/
디렉토리로 이동합니다. -
테마 설정 파일을 계속 진행하세요.
테마 설정 파일 #
웹사이트의 루트 폴더에서 Hugo가 생성한 hugo.toml
(또는 config.toml
) 파일을 삭제합니다. 테마의 *.toml
설정 파일을 config/_default/
폴더로 복사합니다. 이렇게 하면 모든 올바른 테마 설정을 확인할 수 있고, 필요한 경우 테마를 쉽게 사용자 지정할 수 있습니다.
module.toml
파일이 있는 경우 이 파일을 덮어쓰지 마세요!
테마를 설치한 방법에 따라 테마 설정 파일이 다른 위치에 있습니다.
- Hugo Modules: Hugo 캐시 디렉토리에 있거나 GitHub에서 복사
- Git 서브모듈 또는 수동 설치:
themes/congo/config/_default
파일을 복사한 후 설정 폴더는 다음과 같아야 합니다.
config/_default/
├─ config.toml
├─ markup.toml
├─ menus.toml
├─ module.toml # Hugo Modules를 사용한 경우
└─ params.toml
Important: Hugo Modules를 사용하지 않고 Congo를 설치한 경우 config.toml
파일의 맨 위에 다음 줄을 추가해야 합니다.
theme = "congo"
다음 단계 #
Congo 설치는 이제 완료되었습니다. 시작하기 섹션을 방문하여 테마 구성에 대해 더 알아보세요.
테마 업데이트 #
시간이 지남에 따라 테마에 새로운 기능이 추가되고 버그가 수정됩니다. 이러한 변경 사항을 활용하려면 웹사이트에서 테마 파일을 업데이트해야 합니다.
테마를 처음 설치할 때 선택한 설치 방법에 따라 업데이트 방법이 달라집니다. 각 방법에 대한 지침은 아래를 참고하세요.
Hugo 모듈 사용 시 업데이트 #
Hugo는 모듈 업데이트를 매우 쉽게 합니다. 단순히 프로젝트 디렉토리로 이동하고 다음 명령을 실행하세요:
hugo mod get -u
Hugo는 프로젝트에 필요한 모듈을 자동으로 업데이트합니다. 이는 module.toml
및 go.mod
파일을 검사하여 수행됩니다. 업데이트에 문제가 있는 경우 이 파일이 올바르게 구성되어 있는지 확인하세요.
그런 다음 사이트를 다시 빌드하고 모든 것이 예상대로 작동하는지 확인하세요.
hugo mod clean
명령을 사용하여 로컬 캐시를 지우고 사이트를 다시 빌드하세요.
Git 서브모듈 사용 시 업데이트 #
git
명령을 사용하여 서브모듈을 업데이트할 수 있습니다. 다음 명령을 실행하면 로컬 저장소에 최신 버전의 테마가 다운로드됩니다.
git submodule update --remote --merge
서브모듈이 업데이트되면 사이트를 다시 빌드하고 모든 것이 예상대로 작동하는지 확인하세요.
수동 파일 복사 시 업데이트 #
수동으로 테마를 업데이트하려면 최신 테마 소스 코드를 다운로드하고 이전 버전을 프로젝트에 있는 파일로 대체해야 합니다.
-
최신 테마 소스 코드를 다운로드합니다.
Github에서 다운로드 -
아카이브를 추출하고
congo
폴더를 Hugo 프로젝트의 루트 폴더에 있는themes/
디렉토리로 이동합니다. 이 과정에서 테마 파일에 대한 모든 로컬 사용자 지정이 손실됩니다. -
사이트를 다시 빌드하고 예상대로 작동하는지 확인하세요.